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What is an autopatcher/ 
autoupdater? 
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Building the autopatcher 

1. Simple Method 

2 . Manifest 

3. Binary Diffs 
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Manifest 


"overallVersionNumber": 3, 

"files": [ 

"filePath": "Game.exe", 

"CRC": "A34293E0" 

}, 

"f i lePath " : " Assets/Textu re 1 . png ", 
"CRC": "EC01F981" 

}, 

"filePath": "Assets/Texture2.png", 
"CRC": "03B28A6C" 

> 

] 
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Binary Diff Tools 

. VCDIFF / xdelta3 
• bsdiff 
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Diff+Manifest Method 
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Diff+Manifest Method 
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JSON Manifest 

[ 

"filelD": 4, 

"filePath": "ModifiedGameFile.bin", 

"patch": { 

"blobID": 1942, 

"fromBuild": 2, 

"toBuild": 3, 

"filesize": 80949, 

"CRC": "23B4984D", 

"patchMethod": "bsdiff", 

"compression": "LZMA" 

>, 

"full": { 

"blobID": 1940, 

"fromBuild": 0, 

"toBuild": 3, 

"filesize": 104647, 

"CRC": "CB91EAFF", 

"compression": "LZMA" 

"wasDeleted": false, 

"unpackedCRC": "1B1CEABE", 

"latestRev": 3 

>, ... 

] 
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JSON Manifest 


"filelD": 36, 

"filePath": "NewFile.png", 
"full": { 

"blobID": 1424, 
"fromBuild": 0, 

"toBuild": 3, 

"filesize": 17009, 

"CRC": "D21C36CF", 
"compression": "NONE" 

>, 

"wasDeleted": false, 
"unpackedCRC": "D21C36CF", 
"latestRev": 3 
}, - 
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Database 

• Distributions 

• Latest build #, beta build #, stable build # 

• Files 

• Distribution ID, path 

• Revisions / Blobs 

• File ID, from build #, to build #, CRC, etc.. 
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Manifest Generation 


• For each file in distribution 

• SELECT * FROM revisions 
WHERE 

filelD = :fileID AND 
toBuild <= :maxBuild AND 
from Bui Id = :fromBuild AND 
uploadOK = true 
ORDER BY toBuild DESC 
LIMIT 1 

• Cache! 
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Error Handling - Temporary Fails 

• Connection lost 

• Corruption 

• S3 goes AWOL 

> Check CRCs + automatic retries 
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Error Handling - Permanent Fails 

• Firewall 

• Antivirus 

• Malware 

• HDD failure 

> Useful error messages & logging 
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Family Safety Filter "JSON" 

<html> 

<head> 

<script language="javascript" type = "text/javascript"> 
function ProcessData() { 
var noframe = true; 

if(window. parent && window. parent. frames) { 
noframe = window. parent. frames. length < 1; 

> 

if(noframe) { 

window, location .replace(' http://fss. live .com/. .■toApprove=false '); 

} 

else { 

window, location .replacer http://fss. live .com/. .■toApprove=false '); 

> 

} 

</script> 

</head> 

<body onload = "ProcessData();"> 

</body> 

</html> 
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Proxies 

• Rare, but still present 
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Multiple Diff Methods 



Unity add asset - levelO 

Unity add asset - maindata 

Unity add asset - sharedassetsl.assets 


Original File Size KB 

184,074.90 

160,132.00 

838,653.38 

o 

«*— 

c 

Modified File Size 

184,083.49 

160,132.00 

846,231.05 


Change in file size between orig & modified 

8.59 

0.00 

7,577.66 

1/1 

-O 

Patch: bsdiff 

2,486.17 

0.17 

N/A (too big) 

-C 

Patch: xdelta3 

43,053.33 

0.25 

3,589.51 

s 

Modified File | Izma compress 

56,319.26 

32.08 

291,543.23 

to 

Patch: bsdiff | Izma compress 

2,511.66 

0.17 

N/A (too big) 

Q. 

Z> 

Patch: xdelta3 | Izma compress 

32,654.57 

0.18 

3,011.75 
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Fallback 

• Full download option if diff method fails 
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Graceful recovery 

• Power outage mid-update 

• Corrupted install 

• Partially installed 

• Etc. 
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Future changes 

• Security / auth 
. P2P 


GDC 




GAME DEVELOPERS CONFERENCE March 14-18, 2018 • Expo: March 16-18, 2016 #G0C16 


Off-the-shelf solutions 

• Instal IShield 

• RTPatch 

• Unity Asset Store 

• RakNet's patcher 
. AESU? 
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Thank you! 

@8BitMMO 

RobbyZ@ArchiveEntertainment. 
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Attribution 


The following icons were used in this presentation: 

• Cloud icon https://www.iconfinder.com/icons/370088/cloud_cloudy_weather_winter_icon#size = 128 

• TXT icon https://www.iconfinder.com/icons/199323/extension_file_format_txt_icon#size=256 

• Binary icon from https://www. iconfinder.com/icons/298769/binary _file_icon#size= 128 

• PC icon https ://www. iconfinder.com/icons/728976/apple_computer_desktop_device_key boa rd_pc_icon#size= 256 


